home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / os20 / cdity / qmouse261.lha / qmouse.doc < prev    next >
Text File  |  1993-04-10  |  11KB  |  362 lines
  1. QMouse V2.61
  2.  
  3. Written by Dan Babcock
  4.  
  5. -- This program REQUIRES Kickstart 2.0 or higher. --
  6.  
  7. I missed one program more than any other when I switched to
  8. Kickstart 2.0: QMouse, the venerable mouse-utility. I tried every
  9. other program of its type that I could find, but every utility I
  10. tried had quirks, lacked important features, and worst of all was
  11. HUGE. Discouraged (and annoyed), I decided to write my own.
  12. QMouse 2.0 (this program) is a completely new program, not an
  13. update to QMouse, but I couldn't think of a more fitting name;
  14. after all, my intent was to make a utility "like QMouse" - why
  15. not call it QMouse!? I hope this doesn't lead to too much
  16. confusion. On to the all-important feature list...
  17.  
  18. FEATURES:
  19.  
  20. * Automatic window activation after Amiga-M and Amiga-N (or the
  21. screen depth gadget): the previously active window will be made
  22. active. VERY useful!!! Does not poke screen structure like the
  23. original QMouse did (bad :-)).
  24.  
  25. * Optional top-line blanking for 2320/3000 owners who wish to
  26. mask the "half line flicker" effect. Does not blank the border,
  27. just the top line.
  28.  
  29. * System-friendly mouse blanking. Uses only the documented
  30. function SetPointer. Does not interfere with other sprites (e.g.
  31. JRComm's cursor).
  32.  
  33. * Mouse acceleration/threshold
  34.  
  35. * "PopCLI" feature. The CLI (actually any program may be
  36. executed) will have a sensible current directory, stack, and
  37. path.
  38.  
  39. * Click-to-front and click-to-back. Click-to-Back will
  40. intelligently decide whether to perform a Window-To-Back or
  41. Screen-To-Back operation.
  42.  
  43. * SunMouse (activates window under mouse pointer). Personally I
  44. don't care for this feature, but if you like it, it's here.
  45.  
  46. * SunKey (activate window under mouse pointer when you hit a key)
  47.  
  48. * Screen blanking. No special effects; use another program for
  49. that stuff.
  50.  
  51. * NoClick - turn off drive clicking for any combination of
  52. drives.
  53.  
  54. * Can turn on the shell's *=#? feature (like "WildStar" etc.)
  55.  
  56. * Option to automatically make the top screen the default public
  57. screen. This is the same function as PubChange by Steve Koren.
  58.  
  59. * Option to completely disable DisplayBeep (some programs overuse
  60. it and it gets VERY annoying!)
  61.  
  62. * Option to remap a few Northgate keys. (Note: Omnikey Ultra
  63. model)
  64.  
  65. * Starts own background process (no need to RUN).
  66.  
  67. * Written in assembly (efficient). Not a commodity.
  68.  
  69. * Fully public domain. Source code included.
  70.  
  71. * ONLY 4K !!!!!!!!!!!
  72.  
  73.  
  74. -------
  75. Changes
  76. -------
  77.  
  78. V2.10
  79.  
  80. Adds a couple simple options (e.g. noclick and wildstar), and
  81. some internal changes permit left-amiga-cursor mouse movements to
  82. work with mouse blanking enabled.
  83.  
  84. Released on Fish 697.
  85.  
  86. V2.20
  87.  
  88. Older versions (pre-2.11) of QMouse had a serious memory-trashing
  89. bug. This is fixed thanks to Chris Schneider.
  90.  
  91. The problem with the NoFlicker option and virtical overscan,
  92. reported by several people, has been fixed.
  93.  
  94. The "PopCLI" feature now brings the Workbench screen to the
  95. front.
  96.  
  97. Released on Fish 731.
  98.  
  99. V2.21
  100.  
  101. The NoFlicker option now works with Kickstart 3.0 (tested with
  102. 39.106 and 39.110).
  103.  
  104. An informative requester is displayed when QMouse is unable to
  105. deinstall. (Previously it failed silently).
  106.  
  107. A couple extra key remappings added to NorthGate option (numeric
  108. keyboard matches Amiga standard, important for VT100 emulation).
  109.  
  110. V2.30
  111.  
  112. Now works properly in superhires, 800x600, etc. The code actually
  113. shrunk when I fixed this because the offending code wasn't even
  114. needed.
  115.  
  116. The problem of the permanently disappearing pointer, which was
  117. seen most often with reqtools-using programs (for example
  118. GadToolsBox), has been fixed. Nasty software that peeks at
  119. wd_Pointer can still get temporarily confused, but no serious
  120. harm will come of it.
  121.  
  122. Click-to-front is disabled when left-Amiga is pressed. This
  123. avoids a conflict with Snap when double-clicking on some text in
  124. a background window.
  125.  
  126. Task priority set to 20 (same as input.device). Previously it
  127. inherited the priority of the caller.
  128.  
  129. Released on Fish 802.
  130.  
  131. V2.40
  132.  
  133. Added "NoWBenchToFront" and "PubChange" options.
  134.  
  135. Automatic window activation (and PubChange) will now work with
  136. the screen depth gadget as well as Amiga-M/N.
  137.  
  138. An error message ("Bad arguments") is printed if invalid options
  139. are given. (Previously it failed silently).
  140.  
  141. V2.50
  142.  
  143. Due to popular demand I added a delay option (SunMouseDelay) to
  144. the SunMouse option which provides for a delayed response
  145. (similar to Commodore's AutoPoint program, except the delay is
  146. adjustable). This makes it more usable on 68000 machines.
  147.  
  148. Automatic window activation after using the screen depth gadget
  149. didn't quite work in 2.40. Fixed.
  150.  
  151. Major addition/fix: The mouse blanking code is now fully updated
  152. for Kickstart 3.0, patching SetWindowPointerA and
  153. OpenWindowTagList. Much to my surprise these functions are
  154. already used by some commercial software (e.g. FinalCopy II) as
  155. well as Workbench and various 3.0 system software.
  156.  
  157. Made some minor changes to some options (NoClick, Star, Verify)
  158. to be a bit more logical.
  159.  
  160. V2.60
  161.  
  162. Added "ImmBlank" option to allow immediate screen blanking using
  163. Left-Amiga+Right-Amiga.
  164.  
  165. Tuned up the semaphore logic to be more robust.
  166.  
  167. Fixed a minor but annoying bug in the automatic window activation
  168. code.
  169.  
  170. V2.61
  171.  
  172. Fixed a bug in the screen blanking that crept into 2.60.
  173.  
  174. Added the "SunKey" option thanks to the code contribution of
  175. Jaba@desert.wlink.nl (sorry, I don't know your name!)
  176.  
  177. ---------------
  178. Using QMouse V2
  179. ---------------
  180.  
  181. To see the parameter template type "Qmouse ?". Most likely it
  182. looks like gibberish to you, though, so I'll explain the options:
  183.  
  184. (Please note: If you don't specify an option, the option is OFF.
  185. The default set of options is therefore all OFF, except for some
  186. basic features that don't have an option).
  187.  
  188. MBLANK (abbreviated M):
  189.  
  190. This specifies the number of seconds of mouse inactivity     
  191. before the mouse pointer is blanked. The mouse pointer is also
  192. blanked whenever you hit a key.
  193.  
  194. Side note: Many people claim that it is impossible to blank the
  195. mouse in a "system-friendly" way. They're wrong. :-)
  196.  
  197. Examples: m=3, mblank=9, M 10
  198.  
  199. SBLANK (abbreviated S):
  200.  
  201. Screen blanking - works same as mouse blanking basically.
  202.  
  203. ImmBlank:
  204.  
  205. Enable immediate (user-controlled) screen blanking. With this
  206. option enabled, you can hit Left-Amiga and Right-Amiga
  207. simultaneously to blank the screen.
  208.  
  209. NOFLICKER (abbreviated N):
  210.  
  211. This option will blank the top line of the display. (Only useful
  212. to 2320/3000 owners). This function inspects the system copper
  213. list, so it probably won't work in future Kickstarts.
  214.  
  215. Note: If a screen with extreme virtical overscan is being
  216. displayed, QMouse will automatically turn this feature off. To
  217. get rid of the flicker simply drag the screen down a few lines.
  218.  
  219. CMD:
  220.  
  221. Specifies the command to execute when the user hits left-Amiga-
  222. ESCape. Default is "newcli". Use like this: CMD="newcli
  223. con:0/0/640/400". Important!!! The current directory, stack, and
  224. path of the newly created CLI will be that of the CLI where
  225. QMouse was originally executed. Therefore, place QMouse in your
  226. startup-sequence *after* STACK and PATH commands!!
  227.  
  228. The Workbench screen will normally be brought to the front when
  229. executing the command. If you don't want this, use the
  230. "NoWBenchToFront" option.
  231.  
  232. ACCELERATION (abbreviated A):
  233.  
  234. Specifies mouse speed-up factor. QMouse uses the same
  235. acceleration/threshold algorithm as DMouse, by the way (I got
  236. used to the feel).
  237.  
  238. Examples: acceleration 3, a=4, a 9
  239.  
  240. THRESHOLD (abbreviated T):
  241.  
  242. Specifies a threshold (minimum movement) required to apply
  243. acceleration factor. The default is zero. Example: T=1.
  244.  
  245. CLICKTOBACK (abbreviated CTB):
  246.  
  247. Specifying "ctb" or "clicktoback" will enable a feature whereby
  248. both mouse buttons being pressed simultaneously will send the
  249. window under the mouse pointer to the back, OR, if the mouse is
  250. not over a window, or if the window is a backdrop window, or if
  251. the window is the only non-backdrop window on its screen, then a
  252. screen-to-back operation will be performed instead.
  253.  
  254. CLICKTOFRONT (abbreviated CTF):
  255.  
  256. This option specifies the number of mouse clicks required to
  257. bring the window under the mouse pointer to the front. Example:
  258. ctf=2.
  259.  
  260. SUNMOUSE:
  261.  
  262. Specifying "sunmouse" turns on the "Sun Mouse" feature. I don't
  263. recommend you use it because it's annoying and causes problems
  264. with some programs. (Unless you happen to like it :-)).
  265.  
  266. SunMouseDelay:
  267.  
  268. This is a sub-option for SunMouse and specifies a delayed
  269. response to mouse movements. This allows for rapidly moving the
  270. mouse across windows with any jerkiness caused by activating
  271. windows that happen to be "in the way" of the pointer. This
  272. effect is most pronounced on slow (e.g. 68000-based) systems. 
  273.  
  274. This option takes a number argument that specifies the amount of
  275. delay. Typical values are 0 (no delay) and 1 (small delay).
  276. Example: SunMouseDelay=1
  277.  
  278. SUNKEY:
  279.  
  280. Specifiying "SunKey" will cause the window under the mouse
  281. pointer to be activated (if it isn't already) when you press a
  282. key.
  283.  
  284. NOBEEP:
  285.  
  286. Completely disables DisplayBeep (the routine that flashes the
  287. screen).
  288.  
  289. NORTHGATE:
  290.  
  291. For Northgate Omnikey Ultra keyboard users only: remaps a couple
  292. keys. (Page Up -> Shift-Cursor-Up, etc). Sorry, if you want to
  293. change it you'll have to edit the source and reassemble.
  294.  
  295. NOCLICK:
  296.  
  297. Turns off drive clicking option in trackdisk, just like many 2.0-
  298. only 'noclick' programs. The argument to this option is a decimal
  299. number whose (4-bit) binary equivalent corresponds to what drives
  300. should receive the noclick treatment. For example, the number 3
  301. is "0011" in binary, and means drives 0 and 1 (but not 2 and 3)
  302. should be NoClick'ed. To turn off clicking on all drives, specify
  303. NOCLICK=15.
  304.  
  305. Important: If you drive makes funny clicks after using NoClick,
  306. reboot immediately - you can damage a drive that doesn't support
  307. NoClick (which is why the OS defaults to the "clicking" mode).
  308.  
  309. VERIFY:
  310.  
  311. Turns on the floppy disk verify feature of Hackdisk (my
  312. trackdisk.device replacement). If you aren't using Hackdisk this
  313. option is useless.
  314.  
  315. NOVERIFY:
  316.  
  317. Turns off the floppy disk verify feature of Hackdisk (my
  318. trackdisk.device replacement). If you aren't using Hackdisk this
  319. option is useless.
  320.  
  321. STAR:
  322.  
  323. Turns on the *=#? shell feature, similar to programs called
  324. "WildStar" etc.
  325.  
  326. PUBCHANGE:
  327.  
  328. The PubChange option causes the top screen to be automatically
  329. made the default public screen (if the top screen is a public
  330. screen).
  331.  
  332. NoWBenchToFront:
  333.  
  334. This option causes the CMD option to NOT bring the Workbench
  335. screen to the front.
  336.  
  337. QUIT:
  338.  
  339. Completely de-installs QMouse. Note that executing QMouse when
  340. already installed will cause a QUIT to happen first. Due to
  341. extensive SetFunction-ing of the OS, this is considered unsafe.
  342. So please, use only for initial testing (i.e. deciding what
  343. features of QMouse you like and which you don't, etc). Once
  344. you're happy, put QMouse in your startup-sequence and don't mess
  345. with it.
  346.  
  347. Important: If you run another program that SetFunctions some of
  348. the same routines (for example ARQ) you will not be able to QUIT
  349. or modify parameters. To avoid this run QMouse last.
  350.  
  351. ----------
  352. The Author
  353. ----------
  354.  
  355. I can be reached at Dan_E_Babcock@cup.portal.com.
  356.  
  357. Other fine freeware software products by me:
  358.  
  359. FileMount: Utility to create a true partition within a file
  360. Hackdisk: A trackdisk.device replacement offering a verify option
  361.  
  362.